home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / applic / NCSA_Telnet / contributions / NCSA_LU_TELNET / README.NCSA-LU-TELNET < prev    next >
Encoding:
Text File  |  1991-07-29  |  6.0 KB  |  167 lines
  1.  
  2. NCSA/LU Telnet 2.3                              89-12-14
  3. ==================
  4.  
  5. Introduction
  6. ------------
  7. NCSA Telnet is a combined telnet client and FTP server program for the
  8. Macintosh.  It emphasizes a convenient, powerful user interface and
  9. can be configured to match the characteristics of your TCP/IP hosts.
  10. We have included support for a wide variety of Ethernet options.
  11. Complete user documentation is available; printed, or in Macintosh
  12. Microsoft Word format files. [From the original NCSA Telnet readme
  13. file].
  14.  
  15. This version, NCSA/LU Telnet 2.3, is based on the sources for NCSA
  16. Telnet 2.3 and adds the following features:
  17. * support for national characters
  18. * support for printer redirection
  19. Hopefully NCSA will integrate them in a future version.
  20.  
  21. In this document, "telnet" refers to NCSA/LU Telnet and "original
  22. telnet" to NCSA Telnet.
  23.  
  24.  
  25. Availability
  26. ------------
  27. NCSA/LU 2.3 is available via anonymous ftp from pollux.lu.se
  28. (130.235.132.89) in the directory ~ftp/pub/mac/telnet. Get FILES first
  29. to get descriptions of the other files at pollux.
  30. NOTE: pollux may get a new IP number in early January. Send me a mail
  31. if you have problems to connect to it.
  32.  
  33. Original telnet is available via anonymous ftp from ftp.ncsa.uiuc.edu
  34. (141.142.20.50) in the directory NCSA_Telnet/Mac. Some files (incl.
  35. documentation and source) are also available at pollux.
  36.  
  37.  
  38. Documentation
  39. -------------
  40. Original telnet comes with extensive documentation (in MS Word
  41. format). The additions in NCSA/LU telnet are documented in this file
  42. (README). The exact differences are listed in MODIFICATIONS and diffs
  43. to the original source can be found in ncsadiffs.hqx.
  44.  
  45.  
  46. Copyright
  47. ---------
  48. All changes to the original code are public domain.
  49.  
  50. The original telnet (incl. source and documentation) is also public
  51. domain. It is developed at the National Center for Supercomputing
  52. Applications at the University of Illinois at Urbana-Champaign.
  53.  
  54.  
  55. National characters
  56. -------------------
  57. Most European countries have additional characters in their alphabets.
  58. These characters usually have different ASCII codes in Mac ASCII and
  59. US ASCII, and don't always work with terminal emulators. Original
  60. telnet's standard way of handling national characters is just to strip
  61. off the high bit.
  62.  
  63. This version has three 'TRSL' resources for translations between 7 and
  64. 8 bit characters. Being resources, they can easily be configured for
  65. different countries. Those included in this version are for Swedish
  66. ASCII.
  67.  
  68. In the Settings menu, there is a new item, National Chars. When
  69. unchecked, telnet converts 8 bit chars to 7 bit chars, without
  70. preferences for any country. This is a more intelligent version than
  71. just stripping off the high bit, and should be an advantage even for
  72. Americans. The translation is based on resource TRSL #257.
  73. Example: "a with a circle" will be translated to an ordinary a.
  74.  
  75. If National Chars is checked, another translation table (TRSL #259) is
  76. used. This table has to be configured for each country.
  77. Example: "a with a circle" will be translated to a "}", since "a with
  78. a circle" and "}" share the same 7 bit ASCII value in Sweden.
  79.  
  80. When characters are received by telnet they are translated (from 7 to
  81. 8 bit) only if National Chars is checked (TRSL #258).
  82. Example: "}" will be either be passed on unmodified (National Chars
  83. unchecked) or translated to "a with a circle" (National Chars
  84. checked).
  85.  
  86. In brief:
  87. * when a character is sent from telnet (keyboard, paste, send macro)
  88.         if national chars is on then
  89.                 translate with resource TRSL #259
  90.         else
  91.                 translate with resource TRSL #257
  92.  
  93. * when a character is received by telnet (output, echo)
  94.         if national chars is on then
  95.                 translate with resource TRSL #258
  96.         else
  97.                 don't translate at all
  98.  
  99. The format of the TRSL resources is simple. Each resource is
  100. considered as an array, and the character code of the character to be
  101. translated is the index. The value at the position of the index is the
  102. character code for the translated character.
  103.  
  104. In brief:
  105.         translated_char = TRSL_resource[untranslated_char]
  106.  
  107. Each TRSL resource must have a length of exactly 256 bytes.
  108.  
  109. To make it easier, there is a resource with no translation at all
  110. (TRSL #256). Copy it, make the modifications you need, renumber it,
  111. and you are done. TRSL #256 is not used in any way by telnet.
  112.  
  113. The Preferences dialog box (Edit menu) has an extra checkbox named
  114. National Chars. It determines if national chars is the default (or
  115. not) for new connections.
  116.  
  117. NOTE: Be sure to uncheck "Remap option key to control" and "Remap
  118. backquote to ESCape" if you use a non-US keyboard or system.
  119.  
  120.  
  121. Printer redirection
  122. -------------------
  123. This version of telnet supports printer redirection (printer
  124. controller mode). Everything received after "<ESC>[5i" and up to
  125. "<ESC>[4i" is sent to the printer chosen in the Chooser.
  126.  
  127. The text to be printed is temporary saved in a file in the System
  128. Folder. When the code for end-of-printer-redirection arrives, you are
  129. prompted with the standard print dialog. The left margin is about 18
  130. mm (enough for perforation).
  131.  
  132. There are no page numbers on pages printed via printer redirection,
  133. but there are on those printed with Print Selection (File menu).
  134.  
  135. Of course, national chars works with printer redirection and "Print
  136. Selection".
  137.  
  138.  
  139. Roland Mansson, Lund University Computing Center, Sweden.
  140. roland_m@ldc.lu.se
  141.  
  142. ------------------------------------------------------------------------------
  143.  
  144.  
  145. MODIFICATIONS
  146.    Lists all changed files and functions
  147.    Describes all changes
  148.  
  149. RELEASE-NOTES
  150.    Describes what has been changed in new version
  151.  
  152. ncsa-lu-telnet-mactcp.hqx
  153.    NCSA/LU Telnet application (for use with MacTCP)
  154.  
  155. ncsa-lu-telnet.hqx
  156.    NCSA/LU Telnet application (with built-in tcp/ip)
  157.  
  158. ncsadiffs.hqx
  159.    Complete set of diff files (NCSA Telnet vs NCSA/LU Telnet)
  160.  
  161. ncsa-lu-telnet-src.hqx
  162.    NCSA/LU Telnet source code (complete, for use with MPW C 2)
  163.  
  164. NOTE: Files with suffix hqx are compressed and encoded with
  165.       StuffIt and BinHex. Other files are plain text files.
  166.  
  167.